This guide explains how to white label Itential Automation Platform (IAP) with a custom CSS template. The steps outlined in this article will override the default Itential theme.
Requirements
The following items are required.
- File system access to IAP.
- The primary hex color code for your organization, e.g.,
#7ab27f. - Company logo for the IAP Log In page.
- Company logo for the IAP header.
The IAP Log In page company logo must meet the following requirements.
| Requirement | Value |
|---|---|
| File Format | PNG |
| File Name | logo.png |
| Dimensions (px) | 256x256 |
| Background | transparent |
The IAP header company logo must meet the following requirements.
| Requirement | Value |
|---|---|
| File Format | PNG |
| File Name | logo-wide.png |
| Dimensions (px) | 40x100 |
| Background | transparent |
Steps
Perform the following steps to white label the user interface of IAP with your custom colors and logo.
Navigate to the UI style direction of IAP.
cd ./node-modules/@itential/pronghorn-core/us/styleEdit the
custom.cssfile.Note: The constants of
custom.csshave been commented out, so as to not affect the system when not in use.Locate the
\*\*\* SECTION HEADER \*\*\*heading in each section of the file.Remove the comments below each heading by removing the slash and asterisk at the start,
/*, and end,*/,of each section.Replace the example hex color codes with the color codes for your company's brand throughout the file.
- Primary Color:
#7ab27f(example code)
- Primary Color:
Replace the temporary logos with your company branded logos.
The company logo for login may be found at the following location.
node_modules/@itential/pronghorn-core/ui/custom/logo.pngThe header logo may be found at the following location.
node_modules/@itential/pronghorn-core/ui/custom/logo-wide.png
Once all steps are complete, the IAP system will be customized to display your company logo and colors.